        Name: freetds
     Purpose: Port of FreeTDS ODBC driver version 0.62.4

This is the FreeTDS ODBC database driver which provides access to
SQL Server and Sybase databases running on remote servers.


Installation
------------
Unlike the other drivers here, installation is a little more complex.

The driver directory contains the driver which should be installed using
ODBCMan.

The FreeTDS directory should be copied into your Choices directory and
will also need configuring.


odbc/ini and odbcinst/ini files
-------------------------------
These files contain example entries for the odbc/ini and odbcinst/ini
files.

These files can be configured using ODBCMan but the entries supplied here
are to give you an idea of what is needed to get basic connectivity up
and running.


Configuring
-----------
odbc/ini
If your odbc/ini file contains the following:

---------------------------------------------------------------------
;
;  odbc.ini
;  Generated by ODBCMan
;  Mon Oct 27 12:15:17 2003
;
[ODBC Data Sources]
NorthWind   = NorthWind database
[NorthWind]
Name              = NorthWind
Description       = NorthWind database
Servername        = glorydb
ServerType        = FreeTDS
Database          = NorthWind
Username          = 
Password          = 
Driver            = <ODBC$DriverDir>.freetds.freetds
UnloadSafe        = 1

---------------------------------------------------------------------

Then the FreeTds/conf file in the Choices.FreeTDS directory must have
an entry for the Servername (in this case 'glory') as follows:

---------------------------------------------------------------------

# Entry for glorydb	
;[glorydb]
;	host = glory
;	port = 1433
;	tds version = 8.0

---------------------------------------------------------------------

The important thing to remember is that the Servername entry in the
odbc/ini file relates to the entry in the FreeTDS/conf file which
then in turn specifies the actual server that the database resides
on.


Building
--------
Requirements: Acorn C compiler
              Acorn libfile
              Acorn C library (32 bit)
              Rink
              TCPIPLibs (32 bit)
              CLibSupport
              FreeTDS 0.62.4 libraries

TCPIPLibs and rink need to be available to compile this. The resulting
files are placed into the driver shared resource, !ODBC.drivers.freetds